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rms shared file structure definitions 


Modified By: 
v03-009 


v03-008 
v03-007 
v03-006 
v03-005 
v03-004 
v03-003 


v03-002 


v03-001 


$HZ0005 Steph me - Zalewski 05-Aug-1983 
Add a one byte flag f eld to GBSB. 

$HZ20004 Stephen H. Zalewski 28-Jun-1983 
Change size of RMS. Facility code fn SFSB. 

KBT0489 Keith B. Thompson 9-Feb-1983 
Add FAB and SHR field to sfsb 

KBT0325 Keith B. Thompson 10-Sep-1982 
Remove all SO aries structure definitions 

$HZ0003 Stephen H. Zalewski, 12-Aug-1982 
Added further definitions to GBSB. 

$HZ20002 Stephen H. Zalewski, 11-Aug-1982 
Changed name of $68 B to $GBSB. 

$HZ0001 Stephen H. Zalewski 10-Aug-1982 
Add GBLB definitions. 

KBT0081 Keith B. Thompso 12-Jul-1982 


Adc: b_curlck, | m4 and |_hbk re "che sfsb. Also fix 
reviston number-in jwhOOOT 


JWHOO001 Jeffrey W. Horn 24-Mar-1982 
Change SIFB to reflect journaling changes to the IFB. 
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SFSB field definitions - shared file synchronization block 
The SFSB contains the information necessary to lock a file for 


RMS synchronization via the VAX/VMS Lock Manager. 


+ 

FILE_NAME 
juaccenpuneersonse ojaeweewmes qveewssese + 
‘PREMODE | CURMODE } BLN BID : 
$emmmoweweweonnoene $eeeewcnn-e $eececeene + 
Resource Name 
Po (Se oe es eR om cen om ee an (> om ee ee oe ee ee oe ner eee we Oe een ae ee soem + 
| Still to be def- | VMS status code ' 
| ined status bits ‘ H 
| Lock Id. (Returned for new locks, ' 
H nput for conversions) ' 
fee terecec en eoccec= $eeceennnn- powecences + 
: unused ' SHR i FAC ' 
$ ewww wow owon enon n= $oeeoonnnne teoceeonne + 
: unused ' 
$m mmm ww ww www w www www mw w www www nnn nono e + 
! HBK - Hi VBN allocated ! 
H EOF - end of file VBN H 


module $SFSBDEF; 


ate SFSBDEF structure fill prefix SFSBS$; 
LENAME OVERLAY union fill; 
FILENAME quadword unsigned; i 
/t 
FILENAME_FIELDS structure fill; ye 


sytitie Ww word unsigned; 

FILL 5 byte dimension 2 fill prefix SFSBDEF ta 
“ADDRESS Longyord unsigned; / 
end FILENAME FIELDS; 


end FILENAME OVERLAY; 


BID byte unsigned; /* 
constant BID 4 equals 16 prefix SFSB tag $C; 
CURMODE byte unsigned; /* 
PREMODE byte i /* 


2: 
RESNAM FIELDS structure fill; 
FAC_CODE longword unsigned; 
FID_NUM word unsigned; 


descriptor of shared file 
resource name is NODE, D 
points to RESNAM, below 


subfield to address descriptor length field 


resource name. 
EVICE, FILE_I 


name 
LE_ID 


* subfield to address descriptor address field 


block id 

sfsb code 

block length in longwords 

Mode of the current lock 

Mode of the previous lock 

32 bytes for name of shared resource 


RMS facility code (RMS$) 
file id word one 
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EV 
d RESNAM FIELDS; 


0 ; 
LKSB_OVERLAY union fill; 
CKSB Longword unsigned; 
LKSB_FIECDS structure fill; 
STATUS word unsigned; 
S$ BITS word unsigned; 
end LRSB FIELDS; 
end LKSB_OVERLAY; 
LOCK_ID Tongword unsigned; 
LVB_OVERLAY union fill; ; 
LVB longword unsigned dimension 


LVB_FIELDS structure fill; 
FAC byte unsigned; 
SHR byte unsigned; 
FILL_1 word fill prefix SFSB 
FILL 2 longword fill prefix 
HBK Tongword unsigned; 
EBK sonexere unsigned; 

end LVB_FIELDS; 

end LVB_OVERLAY; 
end SFSBDEF; 


end_module $SFSBDEF ; 
module $GBSBDEF ; 


4: 


/* keep the next two fields in same order as 


DEF tag 
SF SBDE 


constant BLN equals . prefix SFSB$ tag K; 
constant BLN equals . prefix SFSBS$ tag C; 


$$; 
tag $$; 


4 
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/* 


ile 

co d /* file 
constant FIX_LEN equals 10 prefix SFSB tag ae 
2; /* b 


f word two 


word three 
0 bytes of fixed size data 
s remain to hold device id (node$device_name) 


-— 
ate 
e-aAaa 


yt 


lock status block 

VMS status code 

various status bits 

second longword of LKSB is the lock id 
Lock value block 


Length of sfsb 
Length of sfsb 


they are in FAB 


fac bits from FAB 
sharing bits (from FAB SHR field) 
spare 


RMSI 


1 
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An GBSB field definitions - global buffer synchronization block 
/* The GBSB contains the information mecgerery to determine if a 


/* y.ebet section is already open for a file on a given node, and 
i s used for synchronizing access to the global section. 

/* bee eee eee eee meee seme eee ewes pee eee eesece + 

/*gbsb i‘ FILE NAME 

/* ' (untena@enmont won peweweococe jemnewseny) 

/* H ‘FLAGS ' *CURMODE H BLN : BID |} 

/* Fewer eeeeeooecoecoc= pores eeeeses teens ese + 


/* ee power we monn ne meme nonce ee + 

/*lksb: : Still to be def- | VMS status code ' 

. t ined status bits ‘ ' 
Ww le ee ene se es es en se en es Ay es He oR BORE eee ee 


Lock Id. Seeeureed for new locks, 
input for conversions) 


overgpete S GBSBDEF structure fill prefix GBSB$; 
E_ OVERLAY union fill; 
PILERAME quadword unsigned; /* descriptor of shared file resource name. 
/* resource name is NODE, DEVICE, FILE_ID 
/* points to RESNAM, below 
MARE fjELes qvrusture fill; 


AM N word unsi ve /* subfield to address descriptor length field 
FILL byte dimension 4% fill prefix GBSBDEF tag 
"ADDRESS" FAeUBS;"* unsigned; /* Subfietd to address descriptor address field 
end FILENAME. F 
gre FILENAME OVERLA 
BID byte sata /* block iq 
constant BiD heir 9 prefix GBSB tag $C; /* gbsbc 
BLN b - uns toned; /* lock” = th in longwords 
CUR prte signed; /* Mode of the current lock 
FLAGS bve LAY union fill; 
FLAGS byte unsign ed; /* spare 
FLAGS BITS structure fill; 
NOTACCESSED bitfield mask; /* Process has already decremeted access count for GBS. 


end FLAGS BITS; 
end FLAGS OVERLAY; 
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RESNAM character Longr® 32; 
LKSB_ OVERLAY union fill; 
CKSB longword unsigned; 
LKSB_FIECDS structure fill; 
TATUS word unsigned; 


d: 
FICL_1 longword fill prefix GBSBDEF tag $$; 
FILL.” longword fill prefix GBSBDEF tag $$; 


end_module S$GBSBDEF; 


/* 
/* 


1 
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32 bytes for name of shared resource 
lock status block 


VMS status code 
various status bits 


second longword of LKSB is the lock id 
Number of global buffers in section. 
Number of accessors to global section. 
Size of global section in bytes. 

spare 


spare 
Length of gbsb 
length of gbsb 


{ee 
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